DLM_LOAD

Normally, IDL system routines that reside in dynamically loadable modules (DLMs) are automatically loaded on demand when a routine from a DLM is called. The DLM_LOAD procedure can be used to explicitly cause the code within the .dll or .so file to be loaded.

Examples

Force the JPEG DLM to be loaded:

DLM_LOAD, 'jpeg'

IDL prints:

% Loaded DLM: JPEG.

Manually load a DLM file that is not on !DLM_PATH:

DLM_LOAD, '/users/myname/mycode.dlm'

IDL prints:

% Loaded DLM: MYCODE.

Syntax

DLM_LOAD, Name1 [, Name2,..., Namen]

Arguments

Namen

A string giving the DLM module name or the full filepath to a .dlm file.

Note: In order to use the DLM module name, the DLM must exist within one of the directories on !DLM_PATH (or you can use DLM_REGISTER to manually register a DLM).

Keywords

None

Version History

5.1

Introduced

8.3 Allow a full filepath to the DLM file

See Also

DLM_REGISTER, !DLM_PATH environment variable, IDL_DLM_PATH preference, Dynamically Loadable Modules